Configuring Bot Advanced Settings

This section provides guidance on configuring advanced settings for your bot, allowing you to customize its behavior and functionality to better suit your needs.

General Settings

To set up the general details of your bot, navigate to the General section on the bot Details page and configure the parameters outlined below.

Parameter Description

Name

The name of your bot. This field is mandatory and is automatically filled in with the name provided during bot creation.

Description

Provide a brief description of your bot.

Enable web socket

Tick the checkbox to enable communication over the WebSocket Protocol.

Block file upload

When enabled, restricts users from uploading files within chats.

In DRUID 7.6 and higher, any attempt by users to upload files will be blocked, and they will receive a notification indicating that file uploads are not supported in that particular chat. You can customize this message easily on the Bot details page under Dialogue management > Special messages.

Is out of band upload

By default, users can upload files of maximum 4 MB in the chat.

Important!   For exceptional situations only, select this option to allow users to upload files of up to 30 MB in the chat, instead of the default limit of 4 MB.

Bot Framework Version

Choose between version 3 and version 4 of the Bot Framework. Version 4 offers enhanced customization options and features such as adaptive cards in conversational flows.

AllowedOrigins

Specify the domains from which your bot can be accessed to restrict access to authorized domains only.

Note:  You need to specify the allowed origin in the following format: https://domain.tld; otherwise, it will not take effect. For example: https://druidai.com.
Hint:  You can specify multiple allowed origins separated by comma.

BotId

Bot unique identifier. The system automatically fills in this field.

SourceId

Unique identifier used for elements identification during an import-export process. The system automatically fills in this field.

Special Flows & Predefined Responses

The Bot Designer allows you to define specific responses triggered by special events during a conversation. You can edit predefined responses or set flows to be automatically triggered when certain events occur. To configure special flows and predefined responses:

  1. Navigate to the Dialogue Management section on the bot Details page.
  2. Scroll down to the Keys table listing predefined responses.
  3. Provide the default and localized keys for additional languages for each response.

For more information about special flows, see Special Flows.

Adding and customizing special messages

The DRUID special messages nomenclature comprises two types of messages:

  • Default system messages: These messages are automatically included in all bots by default.
  • New special messages: These messages are not automatically propagated to all bots. New special messages are highlighted in orange for easy identification. It's important to note that the DRUID Flow Engine does not utilize these messages during conversation time.

DRUID special messages are customizable per bot to suit your specific requirements.

To add specific special messages to your bot, click on the Add message to bot icon associated with the desired message(s).

To delete a specific special message from the bot, click the Remove from bot special messages icon () in front of that message.

The table below lists all customizable special messages and describes when each message is sent.

Special Message

Description

AdaptiveCardNotSubmitted

This message notifies the user that they need to submit their response using the options provided in the adaptive card. It is triggered when the user types something else in the chat without completing the required fields in the adaptive card.

CancelReplyMessage

This message is sent by the bot when the user types "cancel" in the chat, acknowledging the cancellation request and confirming that the current process or action has been stopped.

CantDiscloseInformation

This message alerts the user that they do not have  permission to access the matched intent, as their role is not among the flow's roles.

CantInvokeAlertFlow

Error informing that the alert flow cannot be triggered, due to technical reasons.

ChooseVariant

Appears when the flow reaches a step requiring the user to choose from provided options (e.g., choice, hero cards) and intent switching is disabled. If the user enters input that doesn't match any of the available options, this message will be displayed until a valid choice is made.

DoNotSeeMore

 

DoSeeMore

 

DoYouWantToSeeMore

 

FileUploadedInIdle

This message is displayed when a user attempts to upload a file while the conversation is in Idle mode. It informs the user that file uploads are only allowed when actively requested, ensuring a smoother interaction and providing clear feedback.

InactivityCancelConversation

This message is displayed when a conversation is automatically canceled due to user inactivity. If no specific flow is configured for handling inactivity (Inactivity Cancel Conversation Flow), the chatbot responds with this message before ending the conversation. If the inactivity threshold is reached while an inactivity flow is running, this message is also sent before the conversation is dropped.

InactivityWarningMessage

This message is sent as a warning to the user when they have been inactive for half of the set inactivity threshold (Flow Timeout (min)). It appears while the user is on a flow step that requires input mapping, prompting them to respond before the conversation is automatically canceled.

InputValueInterpretationError

This message is displayed when the Flow Engine extracts at least one entity field from the user input but not the specific entity field defined in the input mapping of the flow step. In this case, the chatbot does not proceed and instead prompts the user to clarify their response, ensuring the required entity field is captured correctly.

InsertDateAlso

This is the default message sent to the user during input mapping for a DateTime field when the user's input (response) only includes the time, and the date component is missing.

InsertHourAlso

This is the default message sent to the user during input mapping for a DateTime field when the user's input (response) only includes the date, and the time component is missing.

LoadingExistingConversation

 

NoBotAccess

The default message sent to the user when their when the conversation user roles don’t match any corresponding roles configured on the bot.

NoIntentIdentified

Default fallback message used when the bot doesn’t recognize the user’s intent and no specific “Intent not recognized” flow is configured.

NoPermissionsForTargetIntent

 

NothingImplemented

 

OAuthLink

When a user attempts to access restricted features, this message delivers a secure authentication link directly within the chat. Following this link allows the user to verify their identity and gain the necessary authorization.

ReleaseErrorMessage

This message is sent to the user in the chat when an error occurs during the conversation, notifying them of the issue and prompting further action if needed.

ResetReplyMessage

This message is sent by the bot when the user types "reset" in the chat, confirming that the conversation reset request has been acknowledged.

SensitiveDataInputWarning

This message is displayed during Prompt steps that involve sensitive data handling.

SwearingObjection

Deprecated

UploadFileBlocked

This message is displayed when a user tries to upload a file on a bot that has the "Block file upload" setting enabled in the General section. The bot will prevent file uploads, ensuring that no files can be shared through the chat.

UploadFileFailed

This message is displayed when a user attempts to upload a file that does not meet the defined file restrictions. This can occur if the file type is not supported or if the file exceeds the maximum allowed size. When a file upload fails validation, DRUID raises an exception that can be handled in the flow to guide the user accordingly. For more information, see File Upload.

WaitForConnectorActionComplete

This message is displayed when a user sends a message while a delay is in progress on a flow step. The delay, set between 1 and 10 seconds, occurs between the pre-action and the step message. If the user interacts with the bot during this waiting period, the bot responds with this special message to inform them that it is still processing their request.

Analytics

You can set the currency metric name for Dashboard FTEs. From the Currency drop-down, select the desired currency. If no currency is selected, DRUID uses the default value, EUR.